home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 4: GNU Archives / Linux Cubed Series 4 - GNU Archives.iso / gnu / binutils.7 / binutils / binutils-2.7 / ld / README < prev    next >
Encoding:
Text File  |  1996-07-04  |  1.8 KB  |  55 lines

  1. This is a BETA release of a completely rewritten GNU linker.
  2. It is distributed with other "binary utilities" which should
  3. be in ../binutils.  See ../binutils/README for more general notes,
  4. including where to send bug reports.
  5.  
  6. There are many new features of the linker:
  7.  
  8. * The linker uses a Binary File Descriptor library (../bfd)
  9.   that it uses to read and write object files.  This helps
  10.   insulate the linker itself from the format of object files.
  11.  
  12. * The linker support a number of different object file
  13.   formats.  It can even handle multiple formats at once:
  14.   Read two input formats and write a third.
  15.  
  16. * The linker can be configured for cross-linking.
  17.  
  18. * The linker contains a control language.
  19.  
  20. * There is a user manual (ld.texinfo), as well as the
  21.   beginnings of an internals manual (ldint.texinfo).
  22.  
  23. Installation
  24. ============
  25.  
  26. See ../binutils/README.
  27.  
  28. If you want to make a cross-linker, you may want to specify
  29. a different search path of -lfoo libraries than the default.
  30. You can do this by setting the LIB_PATH variable in ./Makefile.
  31.  
  32. To build just the linker, make the target all-ld.
  33.  
  34. Porting to a new target
  35. =======================
  36.  
  37. See the Porting chapter in the ldint.texinfo manual.
  38.  
  39. Reporting bugs etc
  40. ===========================
  41. See ../binutils/README.
  42.  
  43. Known problems
  44. ==============
  45.  
  46. HP/UX 9.01 has a shell bug that causes the linker scripts to be
  47. generated incorrectly.  The symptom of this appears to be "fatal error
  48. - scanner input buffer overflow" error messages.  There are various
  49. workarounds to this:
  50.   * Build and install bash, and build with "make SHELL=bash".
  51.   * Update to a version of HP/UX with a working shell (e.g., 9.05).
  52.   * Replace "(. ${srcdir}/scripttempl/${SCRIPT_NAME}.sc)" in
  53.     genscripts.sh with "sh ${srcdir}..." (no parens) and make sure the
  54.     emulparams script used exports any shell variables it sets.
  55.